home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / fildr201.zip / FILEDOOR.DOC < prev    next >
Text File  |  1991-05-20  |  10KB  |  288 lines
  1.  
  2.                              FILEDOOR v2.0
  3.  
  4.              A User Friendly File System for the WAFFLE BBS
  5.                              (for MS-DOS)
  6.  
  7.                             Thomas Salzmann
  8.                          tom@salzo.Cary.NC.US
  9.                            Prodigy: CGVS24A
  10.                            BBS:919-481-3787
  11.                   (FILEDOOR.ZIP in the MISC file area)
  12.                   (log in as TRYFILES with pw TRYFILES)
  13.  
  14.  
  15. What is FileDoor?
  16.  
  17. FileDoor is a replacement for Waffle's FILE area, although FileDoor is not
  18. fully compatible with Waffle's file setup.  FileDoor requires a FOSSIL
  19. driver to be present.  X00 has been extensively tested.
  20.  
  21. FileDoor supports:
  22.   - Configurable menus.
  23.   - Find new files by age in days.
  24.   - Search for files by name (description not supported yet).
  25.   - Upload files.
  26.   - Download files.
  27.   - Multi-file download with Z or Y protocols.
  28.   - Commands Find, Download, and New are global in nature and not limited
  29.     to the current or logged file area.
  30.   - Area "hiding" based on user access level.
  31.   - Simple to use interface.  MUCH LESS FRUSTRATING than Waffle's FILE
  32.     system.
  33.  
  34. FileDoor was written by me.  It is Copyright Thomas Salzmann,  1990 - All
  35. Rights Reserved.
  36.  
  37. Disclaimer:  There are absolutely no warantees of any kind on this
  38. software.  Use it at your own risk.  Thomas Salzmann is not responsible
  39. for any use, misuse, or anything else that may occur as the result of using
  40. this software.
  41.  
  42. Credits:  Waffle is a GREAT product written by Thomas Dell.  My hats off
  43. to him for providing a very good way of doing mail and news on a DOS machine!
  44.  
  45. How is FileDoor arranged?
  46.  
  47.   This is a sample tree of a FileDoor file system:
  48.   ----─BBSFILES
  49.        ├─MISC.3
  50.        │ └─DESCRIBE
  51.        ├─PRIVATE.9
  52.        │ └─DESCRIBE
  53.        ├─UPLOAD.2
  54.        │ └─DESCRIBE
  55.        ├─WINDOWS.3
  56.        │ └─DESCRIBE
  57.        └─GIFPICS.3
  58.        | └─DESCRIBE
  59.        + MISC.D
  60.        + PRIVATE.D
  61.        + UPLOAD.D
  62.        + WINDOWS.D
  63.        + GIFPICS.D
  64.  
  65.   Each file area is a directory.  The number following the directory name
  66.   is the access level required to use the file area.  If the access
  67.   required is not met, the area will neither show up nor be valid on the
  68.   area selection menu.
  69.  
  70.   A one line description for each area is stored in the BBSFILES directory
  71.   in a file of same name with type 'D'.
  72.  
  73.   Files are stored in each directory.  Each file's description is stored
  74.   in a file by like name in the DESCRIBE directory.  For example,
  75.   PKZ110.EXE may be found in the MISC area.  Its one line description is
  76.   found in MISC.3\DESCRIBE\PKZ110.EXE.
  77.  
  78. How is FileDoor Invoked?
  79.  
  80.   I have patched WAFFLE.EXE so it no longer responds to FILES as a
  81.   command.  Doing this allows me to have FILES as an external command
  82.   found in \waffle\extern\files:
  83.  
  84.  /shell /local /command="d:\fd -p%d -u%A -l%a -t%t -o%O -b%b -aUPLOAD" /priv=0
  85.  
  86.       -p  port number to use (Fossil Driver required.)
  87.       -u  user id
  88.       -l  access level
  89.       -t  terminal emulation
  90.       -o  time left online
  91.       -b  baud rate
  92.       -z  TEST MODE for local use.  Don't specify -b or -p
  93.       -a  Initial file area to log (optional)
  94.  
  95. How is FileDoor Configured?
  96.  
  97.   FILEDOOR.CFG is the configuration file required by FILEDOOR.  It is
  98.   specifed by an environment variable FILEDOOR
  99.  
  100.   In your Waffle startup BAT file:
  101.  
  102.   set filedoor=d:\filedoor.cfg
  103.  
  104.   sample (d:\filedoor.cfg):
  105.   f:\bbsfiles\
  106.   d:\
  107.   f:\bbsfiles\upload.2\
  108.   XxYyZz
  109.  
  110.   field descriptions for filedoor.cfg:
  111.   1. path to the various file areas
  112.   2. path to the filedoor.m?? files - the menus used by filedoor.
  113.   3. path where uploaded files go.
  114.   4. Protocols allows - implies Y, X, Z bat files in d:\ Y and Z hardcoded to
  115.                      accept multiple files.
  116.  
  117.   files in d:\ (per example above)
  118.   filedoor.exe    25021  11-14-90  21:36
  119.   filedoor.cfg       50  10-15-90  11:11
  120.   filedoor.m00      606  11-08-90  18:40
  121.   filedoor.ma1       44   9-25-90  21:37
  122.   filedoor.ma2       40  11-14-90  21:41
  123.   filedoor.mh1     1523  11-04-90  21:29
  124.   filedoor.mm       532  11-04-90  21:31
  125.   filedoor.mp1      203   9-25-90  22:00
  126.   filedoor.mq1      279   9-29-90  20:30
  127.   x.bat              91   9-22-90  22:09
  128.   y.bat              95   9-22-90  20:36
  129.   z.bat              92   9-22-90  22:09
  130.  
  131.  
  132. Samples of all configuration files:
  133.  
  134. filedoor.m00:
  135. Menu displayed upon entry to the FileDoor.
  136. -------------------------------------------------------------------------
  137. ┌─────┤
  138. │        ┌───┐  ┬     ├───┐   ┌────┐
  139. └─────┐  │   │  │        ┌┘   │    │
  140.       │  ├───┤  │       ┌┘    │    │  B O A R D !!!!!!!!!!
  141. ├─────┘  ┴   ┴  └───┘  ─┴──┤  └────┘
  142.  
  143. SalzoBoard File System Version 2.01 (c) 1990, SJS Microware
  144.  
  145.  o See the UPLOAD section for many new files!
  146.  o Some files are now designated as "(OFFLINE)".  If you'd like to
  147.    download one of these, drop me a note via FEEDBACK and I'll make it
  148.    available for your next download.  We're having a hard disk space crisis!
  149.  o Use PKUNZIP (in MISC file area, part of PKZ110.EXE) to extract ZIP files.
  150.  
  151. WELCOME ~
  152. -------------------------------------------------------------------------
  153.  
  154.  
  155. filedoor.ma1:
  156. Displayed before list of areas.
  157. -------------------------------------------------------------------------
  158.  
  159. Select a file area from the following:
  160.  
  161. -------------------------------------------------------------------------
  162.  
  163.  
  164. filedoor.ma2:
  165. Displayed after list of areas.
  166. -------------------------------------------------------------------------
  167.  
  168. Area (or 'Q' to exit file system): ~
  169. -------------------------------------------------------------------------
  170.  
  171.  
  172. filedoor.mh1:
  173. Help info.
  174. -------------------------------------------------------------------------
  175.  
  176.                         SalzoBoard File System
  177.                      FILEDOOR v2.01 by Tom Salzmann
  178.  
  179.   The SalzoBoard file system is a BBS "door" which I wrote to replace the
  180.   very hard to use file section which comes with the Waffle BBS software.
  181.  
  182.   The commands are:
  183.  
  184.   A - Areas.  Select the file area which should be considered the default
  185.       or current area.  This is much like changing a directory under DOS.
  186.  
  187.   L - List Files.  Show all the files in the current area.  This is much
  188.       like the DIR command under DOS.
  189.  
  190.   F - Find Files.  Search all areas for a certain file name.  You may use
  191.       wild cards to specify the file name.  For example:  q*.*  qm42?#?.*
  192.       etc.  Any valid DOS wildcard may be used.
  193.  
  194.   N - New Files.  The name is a bit misleading, but this function lists
  195.       files which are newer (to the BBS) than a user specifed 'age' in
  196.       days.
  197.  
  198.   D - Download Files.  You may specify files for download to your system.
  199.       The files you specify need not be in the current area.  FILEDOOR
  200.       will find the file for you.  However, the current area is searched
  201.       first.  If for some reason two files on the bbs have the same name,
  202.       downloading from the area containing the file you want will guarantee
  203.       that you get the right one.
  204.  
  205.   U - Upload Files.  Specify a file and description for upload to the BBS.
  206.       All files will be placed in the UPLOAD file area.
  207.  
  208.   Q - Quit the file system.
  209.  
  210.   ? - Help.  This help information.
  211.  
  212. -------------------------------------------------------------------------
  213.  
  214.  
  215. filedoor.mm:
  216. Main Menu.
  217. -------------------------------------------------------------------------
  218. ╔═════════════════════════════════════════════════════╗
  219. ║ SalzoBoard File Commands:                           ║
  220. ╟─────────────────────────────────────────────────────╢
  221. ║ [A]reas   [L]ist Files  *[D]ownload Files   [Q]uit  ║
  222. ║          *[F]ind Files   [U]pload File      [H]elp  ║
  223. ║          *[N]ew Files                               ║
  224. ╟─────────────────────────────────────────────────────╢
  225. ║ Commands marked '*' now operate across file areas!  ║
  226. ╚═════════════════════════════════════════════════════╝
  227. Enter Command: ~
  228. -------------------------------------------------------------------------
  229.  
  230.  
  231. filedoor.mp1:
  232. Protocols Menu
  233. -------------------------------------------------------------------------
  234.  
  235. Select a Protocol from the following:
  236.  
  237.   Z - Zmodem Batch
  238.   Y - Ymodem Batch (1k blocks)
  239.   X - Xmodem CRC
  240.  
  241. Multiple filenames for download may be specified for Z or Y protocols.
  242.  
  243. Protocol : ~
  244. -------------------------------------------------------------------------
  245.  
  246.  
  247. filedoor.mq1:
  248. Menu before quitting.
  249. -------------------------------------------------------------------------
  250.  
  251. You have asked to exit the SalzoBoard file system.
  252.  
  253. These are your options:
  254.  
  255.   [A]reas   -  Select a new file area and return to the file system.
  256.   [G]oodbye -  Quick disconnect from SalzoBoard.
  257.   [Q]uit    -  Exit file system, return to main prompt.
  258.  
  259. Enter Choice: ~
  260. -------------------------------------------------------------------------
  261.  
  262.  
  263. x.bat:
  264. Xmodem xfer bat.
  265. -------------------------------------------------------------------------
  266. @echo off
  267. if %1. == S. C:\UTIL\DSZ port %3 sx %2
  268. if %1. == R. C:\util\dsz port %3 rx %2
  269. -------------------------------------------------------------------------
  270.  
  271.  
  272. y.bat:
  273. Ymodem xfer bat.
  274. -------------------------------------------------------------------------
  275. @echo off
  276. if %1. == S. C:\UTIL\DSZ port %3 sb -k @%2
  277. if %1. == R. C:\util\dsz port %3 rb %2
  278. -------------------------------------------------------------------------
  279.  
  280.  
  281. z.bat:
  282. Zmodem xfer bat.
  283. -------------------------------------------------------------------------
  284. @echo off
  285. if %1. == S. C:\UTIL\DSZ port %3 sz @%2
  286. if %1. == R. C:\util\dsz port %3 rz %2
  287. -------------------------------------------------------------------------
  288.